メインコンテンツまでスキップ
バージョン: DAI 7.3

Eggplant DAIランナーの使用

Eggplant DAI Runnerでは、Test Configsタブで作成された事前設定されたテストを実行し、カラーコード付きのドットを通じてそれらのテストの結果を表示できます。また、Runnerタブからテストの実行をスケジュールすることもでき、進行中のテストを確認できます。Runnerタブにアクセスするには、Eggplant DAIインターフェースの左側のメニューでControllerをクリックします。

Eggplant DAIのRunnerページ。

テストの実行​

テスト実行を行うには、Runnerタブから実行したいTest Configsに対して Runボタンをクリックします。複数のテストを実行する場合は、この手順を繰り返します。

ノート

Eggplant FunctionalまたはEggplant DAIスニペットエディターで手動で変更したスクリプトをテスト実行前に実行環境（Manage Agents > Manage Suites）に再アップロードすることを忘れないでください。そうしないと、変更が上書きされる可能性があります。

重要

親モデルを通じて実行された場合、サブモデルは親モデルと同じSuiteを使用します。

進行中のTest Configsインスタンスを停止するには、をクリックします。

ノート

Test Configsスケジュールの一部であるテスト実行を中止すると、その構成スケジュールに属する_すべて_の実行が中止されます。

ノート

同じテスト構成の別のテスト実行が進行中の場合、スケジュールされた時間に実行されるか、 Runボタンをクリックして実行される場合、新しく開始されたテスト実行はすぐにエラーで完了します。

Runnerインターフェースでは、テスト構成に関する以下の情報が表示されます：

  • Test Configs： テスト構成の名前。この列はアルファベット順に並べ替えることができます。

  • Model/Suite： 選択されたTest Configsに使用されたEggplant DAIモデルまたはSuiteへのリンク。それぞれ左側にあるアイコン、ビルディングブロック がモデルを、フォルダ がSuiteを表します。

  • Schedule Type: テスト構成のスケジュールのタイプ。指定されたテスト構成にスケジュールが存在しない場合、No Scheduleと表示されます。スケジュールタイプの一覧については、以下のScheduling Options を参照してください。

  • Scheduled Start： 与えられた構成のスケジュールされたテスト実行が開始される日時。そのTest Configsにスケジュールが存在しない場合、このフィールドは空白です。

  • Previous Results： カラーコード付きのドット（下記参照）を通じて、最新10回のテスト実行（該当する場合）の結果を表示します。個々のドットにカーソルを合わせると、実行のステータスと日時が表示されます。クリックして、その実行の結果のスナップショットを表示します。

    pass icon テストが成功したことを示します。

    fail icon テストが失敗したことを示します。

    in-progress icon Test Configsが進行中であることを示します。

    cancel icon テストがエラーで結果となったことを示します。

    abort status テスト実行が中止されたことを示します。

詳細については、実行結果の表示を参照してください。

  • Last Executed： 最も最近の実行の日時。テスト実行が進行中の場合はIn Progressと表示されます。この列は年代順に並べ替えることができます。

実行結果の表示​

詳細なテスト実行結果のアクセス
「Previous Results」列では、個々の実行結果アイコンをクリックすることで、Test Configsの実行に関する洞察を得ることができます。これらのアイコンは、 pass icon 合格、 fail icon 失敗、 in-progress icon 進行中、 cancel icon エラー、または abort status 中止 などのさまざまな結果を表しています。これらをクリックすると、テスト実行の詳細な要約が展開されます。

テスト実行の概要表示
この要約では、以下の情報が見つかります：

  • Execution result： テストが成功したか問題に遭遇したかを示します。
  • Run details： 実行が開始された時刻、その期間、System Under Test (SUT)に関する情報などの詳細。
  • Steps completed： 正常に実行されたステップの数。
  • Total reruns completed： すべてのステップで実行された再実行の合計回数。
  • Total test runs completed： 初期実行と必要な再実行を含む全体的なテスト実行の数。

Donut chart
Donut chart は、Test Configsの結果を視覚的に表現します。このチャートには次の情報が表示されます：

  • Passed first time： 最初の試行で合格したテストケースの数。
  • Passed after rerun： 初期に失敗したが、再実行後に最終的に合格したテストケース。
  • Failed： 成功基準を満たさなかったテストケース。
  • Errored： 実行中にエラーに遭遇したテストケース。
  • Cancelled： 完了しなかったテストケース。
  • In progress： 現在実行中のテストケース。

複数回の再実行が行われるケースでは、ドーナツチャートは再実行の最終結果のみを表示します。再実行機能について詳しくは、次のページを参照してください： Test Configuration

Test Configs Logs
テストプロセスと詳細なテストケース実行結果についてより深く理解するために、Test ConfigsLogsを参照できます。これらのログには、テストと関連する詳細が記録されています。

Pass, Fail, In Progressのドットをクリックすると、テスト実行の概要が表示されます

選択したテスト実行の結果をさらに詳細に調べるためにOpen in resultsをクリックします。これによりResultsタブが開き、選択したテスト実行のすべての個別のテスト実行が表示されますが、画面上部のView all resultsリンクをクリックすることでデフォルトのAll Runsビューに切り替えることができます。Open in resultsボタンは、Errorstateになった実行を除いてすべてのテスト結果に利用可能です。

cancel icon エラー実行ドットをクリックすると、拡大表示されたビューでエラーの理由が表示されます：

拡大した概要を表示するためにクリックします

Runnerからテスト実行の削除​

Previous Results列で、pass icon 成功、fail icon 失敗、in-progress icon 進行中、cancel icon エラー、abort status 中止を表す個々のカラーコード付きドットをクリックして、そのテスト実行の概要を拡大表示で確認します。

拡大表示でOpen in Resultsをクリックすると、選択したテスト実行の結果をさらに詳細に調べることができます。これによりTest Resultsタブが開き、選択したテスト実行のすべての個別のテスト実行が表示されます。

画面の右上隅にはDelete Runとラベル付けられた赤いボタンがあります。これをクリックすると確認ボックスが表示されます。削除を進めるにはConfirmをクリックします。

選択したテスト実行のインスタンスおよびその結果のすべてが削除されます。

削除が完了すると、画面はRunnerタブに戻ります。

テスト実行のスケジュール設定​

スケジューリングは、特定の間隔でテストを実行し、必要な頻度で実行することができるため、テストランに大きな柔軟性をもたらします。

ノート

同じテスト構成に対する別のテスト実行が進行中の場合、新しく開始されたテスト実行は即座にエラーで完了します。これは、スケジュールされた時間に実行されるか、または Run ボタンをクリックして実行される場合にも適用されます。

テストスケジュールタイプ ランワンス

スケジュールオプション​

上記のTest Configsscheduleページを使用して、テスト構成の実行のスケジュールを設定します。Test Configsscheduleページを表示する方法は、次の2つの方法のいずれかを使用できます。

  • Designerページ（Controller > Runner）を表示し、スケジュールを設定したいテスト構成を見つけ、指定されたスケジュールタイプをクリックします（デフォルトのスケジュールタイプはNo scheduleです）。
  • Designerページを表示し、スケジュールを設定したいテスト構成を見つけ、そのActionメニュー（...）をクリックし、Editを選択します。

DAI provides the following schedule types:

schedule type説明
No Schedule (default)Runs are not scheduled for this test config. You do not see the calendar date or time selectors on the Test config schedule page for this option.
Run once at selected timeRuns a test once at the selected date and time. Selecting this option displays the calendar date and time selectors shown above.
Run on selected then repeat everyRuns a test at the selected date, time, and frequency. This option displays the calendar and time selectors, and a Repeat every field with a drop-down list shown below where you can select Days (default), Minutes, Hours, or Weeks. Selecting this option runs the test for the first time at the selected date and time, and then repeatedly according to the frequency you specify. repeat every schedule
CustomRuns a test at a specified date and time, and provides the option to use Cron syntax in the Custom time interval field shown below. Selecting this option runs the test for the first time at the selected date and time, and then repeatedly according to the Cron syntax schedule you specify. DAI Cron syntax recognizes Monday as the first day of the week instead of Sunday as shown below in Custom Cron Schedule Examples. Custom Cron Syntax

Custom Cron Schedule Examples​

# schedule executing at midnight from Monday to Friday \{#schedule-executing-at-midnight-from-monday-to-friday}
0 0 * * 0-4 

# schedule executing every weekday at 5:30PM \{#schedule-executing-every-weekday-at-530pm}

:::注意点

Cron構文の使用方法についての情報については、Custom time intervalフィールドの横にあるヘルプ（?）ボタンをクリックしてください。また、この記事も参照できます。 Cron 構文の使用に慣れていないが、さらに詳しく知りたい場合は、カスタマー サポート までお問い合わせください。

:::

ステップバイステップ：テストのスケジュール設定​

  1. 以下の2つの方法のいずれかを使用して、Test config scheduleページを表示します:

    • Runnerページ（Controller > Runner）に移動し、スケジュールを設定したいテスト構成を見つけ、指定されたスケジュールタイプをクリックします。
    • Runnerページに移動し、スケジュールを設定したいテスト構成を見つけ、そのテスト構成のActionメニュー（...）をクリックし、Editを選択します。

  2. 希望するスケジュールオプションのラジオボタンを選択してください:

    • Run once at selected time
    • Run on selected time and repeat every
    • Custom

    Test Configsscheduleページには、選択したスケジュールオプションとStart date and timeのカレンダー日付と時間のセレクタが表示されます。

    • Run on selected and the repeat everyを選択した場合、スケジュールオプション の上に表示されているRepeat everyフィールドと間隔セレクタも表示されます。
    • Customを選択した場合、スケジュールオプション で上に表示されているように、Custom time intervalフィールドも表示されます。ここには、Cron構文を入力することができます。

  3. テスト構成を実行する日時、または最初に実行する日時を選択し、適切な場合は時間間隔またはCron構文を指定してください。

  4. スケジュールを保存するにはSaveをクリックし、破棄する場合はCancelをクリックしてください。

すべての実行を表示する​

Test Configs内のすべての実行を表示できます。これには、実行されなかった実行、進行中の実行、通常の合格または失敗ステータスの実行が含まれます。Test Configs内のすべての実行を表示することは、失敗した実行の原因を特定するための詳細を見つけるのに特に役立ちます。

実行履歴を表示する​

Actionメニュー から、履歴を表示したいTest ConfigsのView Allを選択します。最新の実行を表示する別のインターフェースが開きます：

  • Execution Date： Test Configsの日時。
  • Status： カラーコード付きカプセル形式でテスト実行のステータスを表示します。オプションは以下の通りです：
    • Success
    • Failed
    • In Progress
    • Error
    • Canceled
  • Open in Results： Open in Resultsをクリックして、選択したテスト実行の結果をさらに詳細に調べます。これによりResultsタブが開きますが、View all resultsをクリックすることでデフォルトのAll Test Runsビューに切り替えることができます。
  • Expand row button： 選択した実行の結果のスナップショットを表示するためにクリックします。

RunnerナビゲーションリンクをクリックしてRunnerタブに戻ります。

実行履歴からテスト実行を削除する​

Open in Resultsをクリックして、選択したテスト実行の結果をさらに詳細に調べます。これによりResultsタブが開き、選択したテスト実行のすべての個別のテスト実行が表示されます。

画面の右上隅にはDelete Runとラベル付けられた赤いボタンがあります。これをクリックすると確認ボックスが表示されます。削除を進めるにはConfirmをクリックします。

選択したテスト実行のインスタンスおよびその結果のすべてが削除されます。

削除が完了すると、画面はRun Historyタブに戻ります。

に最終更新